home *** CD-ROM | disk | FTP | other *** search
/ Shareware Universe - The Gold Collection / Shareware Universe The Gold Collection.iso / utility / hexedit / hexedit.go < prev    next >
Encoding:
Text File  |  1996-04-19  |  20.3 KB  |  425 lines

  1. 6-07-94 HexEdit rev 1.3
  2.  
  3.         TABLE OF CONTENTS
  4.  
  5.         1. INTRODUCTION
  6.                 System Requirement                                      3
  7.                 File Size Restrictions                                  3
  8.                 What You Need to Know                                   3
  9.  
  10.         2. GETTING STARTED
  11.                 Backing Up HexEdit                                      3
  12.                 Installing Onto A Hard Disk                             4
  13.                 Running HexEdit                                         4
  14.  
  15.         3. FEATURES
  16.                 Getting Help                                            4
  17.                 Menus                                                   4
  18.                 Entering Bytes                                          5
  19.                 Cursor Movement                                         5
  20.                 Function Keys                                           5
  21.                         F1 - Help                                       5
  22.                         F2 - File Menu                                  5
  23.                                 Save file                               5
  24.                                 Save and name file                      5
  25.                                 Save file and exit                      5
  26.                                 Insert file                             5
  27.                                 Write block to file                     5
  28.                                 Quit, abandon edits                     5
  29.                         F3 - Edit Menu                                  5
  30.                                 Delete byte                             5
  31.                                 Delete block                            5
  32.                                 Begin block mark                        5
  33.                                 End block mark                          5
  34.                                 Clear block marks                       5
  35.                                 Copy block                              5
  36.                                 Move block                              5
  37.                                 Toggle overtype/insert mode             5
  38.                                 Toggle hex/character mode               6
  39.                                 ASCII character set window              6
  40.                         F4 - Goto Menu                                  6
  41.                                 Go to address                           6
  42.                                 Find byte string                        6
  43.                                 Previous page                           6
  44.                                 Next page                               6
  45.                                 Beginning of file                       6
  46.                                 End of file                             6
  47.                         F5 - DOS Command                                6
  48.                 Alt Keys                                                6
  49.                         Alt+a   ASCII character set window              6
  50.                         Alt+b   Begin block mark                        6
  51.                         Alt+c   Copy block                              6
  52.                         Alt+d   Delete block                            7
  53.                         Alt+e   End block mark                          7
  54.                         Alt+f   Find byte string                        7
  55.  
  56.  
  57.                                         1
  58.  
  59.  
  60.  
  61.                         Alt+g   Go to address                           7
  62.                         Alt+h   Toggle hex/character mode               7
  63.                         Alt+i   Insert file                             7
  64.                         Alt+m   Move block                              7
  65.                         Alt+n   Save and name file                      7
  66.                         Alt+q   Quit, abandon edits                     7
  67.                         Alt+r   Clear block marks                       7
  68.                         Alt+s   Save file                               7
  69.                         Alt+w   Write block to file                     7
  70.                         Alt+x   Save file and exit                      7
  71.                 Special Keys                                            7
  72.                         BS                                              7
  73.                         Del                                             7
  74.                         End                                             7
  75.                         Enter                                           7
  76.                         Esc                                             7
  77.                         Home                                            7
  78.                         Ins                                             7
  79.                         PgDn                                            7
  80.                         PgUp                                            7
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                         2
  119.  
  120.  
  121.  
  122.         INTRODUCTION
  123.  
  124.         Thank you using HexEdit.  HexEdit is an easy-to-use binary or text
  125.         file editor containing both hex byte and text editing features.
  126.         With most text editors, non-printable characters are not displayed
  127.         on the screen and editing these non-printable characters are
  128.         difficult if not impossible.  HexEdit displays all bytes within a
  129.         file(including non-printable characters) and provide powerful byte
  130.         editing features for the serious user.
  131.  
  132.         A character mode is available for quickly typing in characters rather
  133.         than editing bytes.  An ASCII character set window is also available
  134.         for viewing or entering characters from the window.
  135.  
  136.         1. System Requirements for HexEdit
  137.                 HexEdit requires an IBM XT,AT,PS1,PS2,Tandy,386,486,Pentium
  138.                 or 100% compatible with 640K RAM.
  139.  
  140.         2. File Size Restrictions
  141.                 Because the HexEdit file being edited is fully loaded into
  142.                 RAM(fast editing), file sizes are restricted by the amount
  143.                 of available RAM.  The default maximum file size is 262,144
  144.                 bytes.  Editing files larger than 262,144 is possible if
  145.                 enough conventional RAM memory is available on your system.
  146.                 Removing TSR's loaded into conventional memory will increase
  147.                 RAM.  See "3. Running HexEdit" below for more information on
  148.                 editing files larger than 262,144 bytes.
  149.  
  150.         3. What You Need to Know
  151.                 HexEdit was designed for the computer user who requires to view
  152.                 or edit bytes within a file.  I assume that you know how to
  153.                 turn on your computer and run DOS.  Review the manuals that
  154.                 came with your computer if you are unfamiliar with it.
  155.  
  156.                 Terms You Need To Know
  157.                         Default is a setting which is initially set when
  158.                         HexEdit is first used.  For example, when you run
  159.                         HexEdit, it assumes that you with start your editing
  160.                         in overtype mode and hex mode.
  161.  
  162.                         Toggle is a feature which switched the settings to the
  163.                         next possible choice.  For example, if you are in
  164.                         overtype mode and wish to change to insert mode,
  165.                         pressing the INS key will toggle the mode to insert
  166.                         mode.  Pressing INS again will toggle you back to
  167.                         overtype mode.
  168.  
  169.  
  170.         GETTING STARTED
  171.  
  172.         1. Backing Up HexEdit
  173.                 Before you begin using HexEdit, you should make a back-up copy
  174.                 of the program to another disk and on your hard disk. Back-ups
  175.                 save time and problems if something should ever happen to your
  176.                 original HexEdit program.  Refer to the DOS manual that came
  177.  
  178.  
  179.                                         3
  180.  
  181.  
  182.  
  183.                 with your computer if you are unfamiliar with COPY or DISKCOPY.
  184.  
  185.         2. Installing Onto You Hard Disk
  186.                 HexEdit is completely contained on a single file.  Just copy
  187.                 HE.EXE into any directory within your path or make a new
  188.                 directory.  HexEdit requires no hardware set-up.
  189.  
  190.         3. Running HexEdit
  191.                 There are three different ways to run HexEdit.
  192.  
  193.                 A. Running HexEdit without a file:
  194.                         Type HE and press Enter.  A file called NO_NAME.HEX
  195.                         will be created with no bytes.  When editing is
  196.                         complete, you can press Alt+n to save and name file.
  197.  
  198.                 B. Running HexEdit with a file:
  199.                         Type HE FILENAME and press Enter.  FILENAME is the name
  200.                         of the file for editing.
  201.  
  202.                 C. Running HexEdit with a file and changing its file
  203.                    allocation size.
  204.  
  205.                         Type HE FILENAME ALLOCATION_SPACE and press Enter.
  206.                         Examples:  HE FILENAME.HEX 100000
  207.                                    HE FILENAME.HEX 350000
  208.                         FILENAME is the name of the file for editing.
  209.                         ALLOCATION_SPACE is a decimal number which specifies
  210.                         the amount of 640K RAM necessary to edit FILENAME.
  211.  
  212.                         This method of running HexEdit should be avoided unless
  213.                         memory allocation errors occur.  The default allocation
  214.                         size used to load a file into HexEdit is 262,144 bytes.
  215.                         Files larger than 262,144 bytes will require more
  216.                         allocation space.  The amount of space which cam be
  217.                         allocated is dependent on the amount of 640K RAM still
  218.                         available on your system AFTER loading HexEdit.
  219.  
  220.  
  221.         FEATURES
  222.  
  223.         1. Getting Help
  224.                 When you start HexEdit, a main menu appears with a choice for
  225.                 Help.  While in the editor, press the F1 key to display the
  226.                 help screen.
  227.  
  228.         2. Menus
  229.                 HexEdit uses pop-up menus that offer a set of choices or option
  230.                 in an organized manner.  When you first run HexEdit, you will
  231.                 drop directly into the Main Menu.  A menu option will be
  232.                 highlighted.  Press Enter to select the highlighted choice.  To
  233.                 select a different option, use the arrow keys to highlight your
  234.                 choice and press Enter or press the highlighted character.
  235.  
  236.                 While a menu is open in the editor, the left or right arrow
  237.                 keys can be used to open adjacent menus.  Press the ESC key
  238.  
  239.  
  240.                                         4
  241.  
  242.  
  243.  
  244.                 to cancel a menu.
  245.  
  246.         3. Entering Bytes
  247.                 In the upper-right corner of the editor screen, a working area
  248.                 appears for editing the present address location.  In overtype
  249.                 mode, the byte of the present address will appear in this
  250.                 working area.  In insert mode, this working area will appear as
  251.                 dashes until data is typed in.  Once the change is completed,
  252.                 press Enter to load the change into the editor.
  253.  
  254.         4. Cursor Movement
  255.                 Cursor movement within the editor is done by moving the Arrow
  256.                 keys, HOME, END, PgUp or PgDn key.  To move the cursor to a
  257.                 specific address location, use Alt+G (Go To Address).  Alt+F
  258.                 (Find Byte String) will also move the cursor to the next
  259.                 address containing the specified byte string.
  260.  
  261.         5. Function Keys
  262.                 These five special function keys are displayed on the top
  263.                 menu of the editor screen.
  264.  
  265.                 F1 - Help
  266.                 The help screen displays all the key and key combinations.
  267.  
  268.                 F2 - File Menu
  269.                 List various choices related to file operation.
  270.  
  271.                 Save file - Saves contents of editor under the current file
  272.                         name and resumes editing.
  273.                 Save and name file - Requests a new file name, saves the
  274.                         contents of editor and resumes editing.
  275.                 Save file and exit - Saves contents of editor and returns to
  276.                         main menu.
  277.                 Insert file - Insert a file starting at the current address
  278.                         location.
  279.                 Write block to file - Requests a file name and saves bytes
  280.                         within block marks.
  281.                 Quit, abandon edits - Returns to main menu without saving
  282.                         changes to file.
  283.  
  284.                 F3 - Edit Menu
  285.                 List various choices related to editing operation.
  286.  
  287.                 Delete byte - Deletes byte in the current address location.
  288.                 Delete block - Deletes bytes located within the block marks.
  289.                 Begin block mark - Marks the current location as the beginning
  290.                         of the block.
  291.                 End block mark - Marks the current location as the end of the
  292.                         block.
  293.                 Clear block marks - Remove block marks.
  294.                 Copy block - Copies the bytes within the block marks to the
  295.                         current address location.
  296.                 Move block - Moves the bytes within the block to the current
  297.                         address location.
  298.                 Toggle overtype/insert mode - Changes the mode from which bytes
  299.  
  300.  
  301.                                         5
  302.  
  303.  
  304.  
  305.                         are loaded into the editor.  Overtype mode (default
  306.                         mode) overwrites the contents of the byte in the
  307.                         current address location.  Insert mode will push all
  308.                         bytes equal to or greater than the current address
  309.                         location and insert the byte, block or file into the
  310.                         current address location.
  311.                 Toggle hex/character mode - Allows the user to edit characters
  312.                         instead of bytes.  Hex mode (default mode) allows the
  313.                         user to edit bytes.  Character mode allows the user to
  314.                         change bytes by typing characters.  Only printable
  315.                         ASCII characters may be used.  Printable is ASCII
  316.                         21h - 7Fh.
  317.                 ASCII character set - Use the ASCII character set window Alt+a
  318.                         for viewing or entering printable or non-printable
  319.                         characters.  Press the ESC key to remove the window.
  320.  
  321.                 F4 - Goto Menu
  322.                 List various choices related to moving the current address
  323.                 location.
  324.  
  325.                 Go to address - Move to the specified hex address location.
  326.                 Find byte string - Find the specified byte string.  Use the
  327.                         arrow keys to move to the next byte or previous bytes.
  328.                         Press Enter to begin search.  Alt+a can be used to
  329.                         enter characters.  The search begins at the present
  330.                         address location.
  331.                 Previous page - Move to the previous address screen.
  332.                 Next page - Move to the next address screen.
  333.                 Beginning of file - Go to the first address location.
  334.                 End of file - Go to the last address location.
  335.  
  336.                 F5 - DOS Command
  337.                 Allows the user to execute a DOS command.
  338.                 For example, if you want to insert a file into the editor but
  339.                 can't remember the file name, press F5.  Type DIR and press
  340.                 Enter.  Files in the current directory are displayed.  Press
  341.                 any key to return to editing.
  342.  
  343.         6. Alt Keys
  344.                 Allows the user to run task quickly rather than sifting through
  345.                 the menus on the top of the editor screen.
  346.  
  347.                 The Alt key is designed to be used in combination with another
  348.                 key to run the specified task.  For example, to use the ASCII
  349.                 character set window, hold down the Alt key and press the
  350.                 letter A.  The ASCII character set window appears on the
  351.                 screen.
  352.  
  353.                 Alt+a   ASCII character set window - Allows the user to view or
  354.                         enter an ASCII character into the editor.  Use arrow
  355.                         keys to select character within window and press Enter
  356.                         or press the ESC key to remove the window.
  357.                 Alt+b   Begin block mark - Marks the current address location
  358.                         as the beginning of the block.
  359.                 Alt+c   Copy block - Copies the bytes within the block marks to
  360.  
  361.  
  362.                                         6
  363.  
  364.  
  365.  
  366.                         the current address location.
  367.                 Alt+d   Delete block - Deletes bytes located within the block
  368.                         marks.
  369.                 Alt+e   End block mark - Marks the current location as the end
  370.                         of the block.
  371.                 Alt+f   Find byte string - Find the specified byte string.
  372.                         Use the arrow keys to move to the next byte or previous
  373.                         bytes, then press Enter to begin search.  Alt+a can be
  374.                         used to enter characters.  The search begins at the
  375.                         present address location.
  376.                 Alt+g   Go to address - Move to the specified address.
  377.                 Alt+h   Toggle hex/character mode - Allows the user to edit
  378.                         characters instead of bytes.  Hex mode (default mode)
  379.                         allows the user to edit bytes.  Character mode allows
  380.                         the user to change bytes by typing characters.  Only
  381.                         printable ASCII characters can be used.  Printable is
  382.                         ASCII 21h - 7Fh.
  383.                 Alt+i   Insert file - Insert a file starting at the current
  384.                         address location.
  385.                 Alt+m   Move block - Moves the bytes within the block marks to
  386.                         the current address location.
  387.                 Alt+n   Save and name file - Requests a new file name, saves
  388.                         the contents of editor and resumes editing.
  389.                 Alt+q   Quit, abandon edits - Return to main menu without
  390.                         saving changes.
  391.                 Alt+r   Clear block marks - Remove block marks.
  392.                 Alt+s   Save file - Save contents of editor under current file
  393.                         name and resumes editing.
  394.                 Alt+w   Write block to file - Requests a file name and saves
  395.                         bytes within block marks.
  396.                 Alt+x   Save file and exit - Save contents of edit under
  397.                         current file name and return to main menu.
  398.  
  399.         7. Special Keys
  400.                 BS      Use backspace to delete the previous character.
  401.                 Del     Deletes the byte or character, depending on mode in
  402.                         use.
  403.                 End     Go to the last address location.
  404.                 Enter   Used to enter a byte, string or choice from a menu.
  405.                 Esc     Cancels menus or windows.
  406.                 Home    Go to the first address location.
  407.                 Ins     Changes the mode in which bytes are loaded into the
  408.                         editor.  Overtype mode (default mode) overwrites the
  409.                         contents of the byte in the current address location.
  410.                         Insert mode will push all bytes equal to or greater
  411.                         than the current address location and insert the byte,
  412.                         block or file into the current address location.
  413.                 PgDn    Move to the next address screen.
  414.                 PgUp    Move to the previous address screen.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.                                         7
  424.  
  425.